home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / dlanst.z / dlanst
Encoding:
Text File  |  1998-10-30  |  2.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4. DDDDLLLLAAAANNNNSSSSTTTT((((3333FFFF))))                                                          DDDDLLLLAAAANNNNSSSSTTTT((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DLANST - return the value of the one norm, or the Frobenius norm, or the
  10.      infinity norm, or the element of largest absolute value of a real
  11.      symmetric tridiagonal matrix A
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      DOUBLE PRECISION FUNCTION DLANST( NORM, N, D, E )
  15.  
  16.          CHARACTER    NORM
  17.  
  18.          INTEGER      N
  19.  
  20.          DOUBLE       PRECISION D( * ), E( * )
  21.  
  22. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  23.      DLANST  returns the value of the one norm,  or the Frobenius norm, or the
  24.      infinity norm,  or the  element of  largest absolute value  of a real
  25.      symmetric tridiagonal matrix A.
  26.  
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      DLANST returns the value
  30.  
  31.         DLANST = ( max(abs(A(i,j))), NORM = 'M' or 'm'
  32.                  (
  33.                  ( norm1(A),         NORM = '1', 'O' or 'o'
  34.                  (
  35.                  ( normI(A),         NORM = 'I' or 'i'
  36.                  (
  37.                  ( normF(A),         NORM = 'F', 'f', 'E' or 'e'
  38.  
  39.      where  norm1  denotes the  one norm of a matrix (maximum column sum),
  40.      normI  denotes the  infinity norm  of a matrix  (maximum row sum) and
  41.      normF  denotes the  Frobenius norm of a matrix (square root of sum of
  42.      squares).  Note that  max(abs(A(i,j)))  is not a  matrix norm.
  43.  
  44.  
  45. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  46.      NORM    (input) CHARACTER*1
  47.              Specifies the value to be returned in DLANST as described above.
  48.  
  49.      N       (input) INTEGER
  50.              The order of the matrix A.  N >= 0.  When N = 0, DLANST is set to
  51.              zero.
  52.  
  53.      D       (input) DOUBLE PRECISION array, dimension (N)
  54.              The diagonal elements of A.
  55.  
  56.      E       (input) DOUBLE PRECISION array, dimension (N-1)
  57.              The (n-1) sub-diagonal or super-diagonal elements of A.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.